home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / win_a_d / dsktrk80.zip / DISKTRKD.DOC next >
Text File  |  1992-12-02  |  70KB  |  1,431 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                            DiskTrak for DOS
  12.                         
  13.                              Version 8.00
  14.  
  15.                           Table of Contents
  16.  
  17.  
  18.      Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  19.  
  20.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  21.  
  22.      Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  23.  
  24.      For Users of the DOS DiskTrak Version 7.xx Program  . . . . . . . . . .   5
  25.  
  26.      System Requirements, Compatibility, and Limitations . . . . . . . . . .   6
  27.  
  28.      Using the Program . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  29.  
  30.      The Window Focus  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  31.  
  32.      Shortcut keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  33.  
  34.      Using the Button Box Push Buttons . . . . . . . . . . . . . . . . . . .   9
  35.  
  36.      FILE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  37.           Open a Database  . . . . . . . . . . . . . . . . . . . . . . . . .  10
  38.           DOS Shell  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  39.           Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  40.  
  41.      ACTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  42.           Add/Update Disk(s) . . . . . . . . . . . . . . . . . . . . . . . .  11
  43.           Add/Edit Comments  . . . . . . . . . . . . . . . . . . . . . . . .  12
  44.           Report to Screen . . . . . . . . . . . . . . . . . . . . . . . . .  13
  45.           Report to File . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  46.           Report to Print  . . . . . . . . . . . . . . . . . . . . . . . . .  13
  47.           Restore Files  . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  48.           Delete Disks . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  49.           Delete Files . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  50.           Label Disks  . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  51.  
  52.      SEARCH  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  53.           Filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  54.           Comment  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  55.           Diskname . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  56.           Duplicate Files  . . . . . . . . . . . . . . . . . . . . . . . . .  17
  57.           Cancel Search Results  . . . . . . . . . . . . . . . . . . . . . .  18
  58.  
  59.      UTILITIES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  60.           Compress Data  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  61.           Expand Data  . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  62.           Make a Database  . . . . . . . . . . . . . . . . . . . . . . . . .  19
  63.           Sort Disknames by Name . . . . . . . . . . . . . . . . . . . . . .  19
  64.           Sort Disknames by Free Space . . . . . . . . . . . . . . . . . . .  19
  65.           Show Free Space  . . . . . . . . . . . . . . . . . . . . . . . . .  20
  66.  
  67.      CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  68.           OK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  69.           Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  70.           Data Disk Drive  . . . . . . . . . . . . . . . . . . . . . . . . .  20
  71.           ZIP Extract  . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  72.           Print Lines/Page . . . . . . . . . . . . . . . . . . . . . . . . .  21
  73.           Report Type  . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  74.           Screen Colors  . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  75.  
  76.      HELP  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  77.           Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  78.           About  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  79.  
  80.      Future Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  81.  
  82.      The DiskTrak for DOS Database . . . . . . . . . . . . . . . . . . . . .  23
  83.  
  84.      Version History . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  85.           Version 8.00 . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  86.  
  87.      Potential Future Enhancements . . . . . . . . . . . . . . . . . . . . .  24
  88.  
  89.      Un-Planned Enhancements . . . . . . . . . . . . . . . . . . . . . . . .  25
  90.  
  91.                                   DiskTrak for DOS
  92.                                     Version 8.00
  93.  
  94.  
  95.                                     Introduction
  96.  
  97.      DiskTrak for DOS was designed to provide a "quick and easy" method for
  98.      keeping track of diskette collections.  DiskTrak for DOS will allow you to
  99.      easily create a database that contains a list of all your diskettes and the
  100.      files and free space available on each one.  Optionally, you can include a
  101.      comment or description for each file on each diskette.  Also, you can have
  102.      DiskTrak for DOS extract the names of files stored inside  "ZIP", "PAK",
  103.      "ARC", "ZOO", and "LZH" archive files (and you can create comments for
  104.      these files as well.)  Then, anytime you want to locate the disk containing
  105.      a particular file, simply enter the filename into DiskTrak for DOS and it
  106.      will tell you the disk (or disks, if there are more than one) that holds
  107.      the file you're looking for.  If you don't know the complete name of the
  108.      file, key in as much of it as you do know and DiskTrak for DOS will search
  109.      its database for all disks containing any file that has the partial name
  110.      you entered embedded in it.   DiskTrak for DOS supports this same database
  111.      search capability for disk names and file comments as well, so if you enter
  112.      descriptive comments for your file names, DiskTrak for DOS allows you to
  113.      find the file based on its comment.
  114.  
  115.      DiskTrak for DOS also has other useful disk and file related capabilities:
  116.      it can label and re-label diskettes, identify duplicate files,  delete
  117.      and/or restore files, and produce 5 types of hard and/or soft copy reports
  118.      of its database contents.  Finally, DiskTrak for DOS supports several
  119.      "usability" functions such as screen color customization, database
  120.      maintenance, and DOS Shell functionality.
  121.  
  122.      Creating and maintaining DiskTrak for DOS databases is easy.  After
  123.      creating a database (see the Make a Database section below for details),
  124.      use the File Open function to open it and then simply "feed" your diskettes
  125.      to DiskTrak for DOS.  The program will read the directories and
  126.      subdirectories on each diskette, extract all filenames (including hidden
  127.      and system files) and the amount of free space, and automatically update
  128.      its database.  If you add or delete files on a diskette, simply "re-feed"
  129.      it into DiskTrak for DOS; the database will be automatically updated. 
  130.  
  131.      DiskTrak for DOS is distributed as "shareware", meaning it is allowed to be
  132.      freely copied and distributed, but if used on a regular basis, must be paid
  133.      for.  If you continue to use DiskTrak for DOS you are obligated to send its
  134.      registration fee ($25.00) to Peninsula Software.  Upon receipt of your
  135.      registration fee, Peninsula Software will mail you a 3.5" 720K diskette (or
  136.      two 5.25" 360K diskettes) containing a copy of the most current version of
  137.      DiskTrak for DOS that is registerted to you exlusively.  Registered
  138.      versions of DiskTrak for DOS do not contain the "Registration Motivator"
  139.      dialog box, and also display the name of the registered user in the "About" 
  140.      window.  Finally, registering will allow Peninsula Software to continue
  141.      further enhancements to DiskTrak for DOS (many features in the current
  142.      version were suggested by registered users) and to develop other low cost
  143.      software products. 
  144.  
  145.      The following sections describe how to install DiskTrak for DOS and how to
  146.      use the program.  After that is a description of each menu selection. 
  147.      Finally, there is a brief discussion of the DiskTrak for DOS database and a
  148.  
  149.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  150.                                         4
  151.  
  152.                                   DiskTrak for DOS
  153.                                     Version 8.00
  154.  
  155.  
  156.      summary of the changes made to DiskTrak for DOS since version 8.00.
  157.  
  158.  
  159.                                     Installation
  160.  
  161.      Installing DiskTrak for DOS is a simple process:
  162.  
  163.      (1) Copy the files DISKTRKD.EXE, SAMPLE.DTW, DISKTRKD.IDX, and DISKTRKD.HLP
  164.      to the directory from which you wish to run DiskTrak for DOS.  DISKTRKD.EXE
  165.      is the DiskTrak program, and SAMPLE.DTW is a sample database you can use
  166.      for testing/evaluation.  DISKTRKD.IDX and DISKTRKD.HLP are, respectively,
  167.      the topic index and text for the program's online Help function.
  168.  
  169.      (2) Start DISKTRKD like any standard DOS application.
  170.  
  171.      DiskTrak for DOS will  use the file SAMPLE.DTW as a "demonstration"
  172.      database.  You can use this database to try out all of the DiskTrak for DOS
  173.      functions, including making updates and deletes, before you create your own
  174.      database.  Later, when you're familiar with how DiskTrak for DOS works,
  175.      create your own database, verify that it works properly, and delete
  176.      SAMPLE.DTW.  (Note -- when you do this BE SURE to first create a DiskTrak
  177.      for DOS configuration file identifying your database as the one DiskTrak
  178.      for DOS should use.  See the section "Config. Save" below for details on
  179.      how to do this.)
  180.  
  181.  
  182.                  For Users of the DOS DiskTrak Version 7.xx Program
  183.  
  184.      Beginning with DiskTrak for DOS Version 8.00, DiskTrak for DOS uses a
  185.      database format different from that used by the DOS version 7.xx
  186.      DISKTRAK.EXE program.  In fact, the database format used by DiskTrak for
  187.      DOS Version 8.00 (or later) is exactly the same as that used by the Windows
  188.      version of DiskTrak.  Consequently, all DiskTrak for DOS database files
  189.      must have a name of the form <name>.DTW.  Databases used by DiskTrak for
  190.      DOS prior to Version 8.00 are all named <name>.DT7.  If you have a database
  191.      of this form and you want to convert it for use by DiskTrak for DOS Version
  192.      8.00 (or later), simply copy each of your <name>.DT7 database files to
  193.      <name>.DTW.  Then, when opened by DiskTrak for DOS, you will be asked if
  194.      you want to convert the database to the format required by DiskTrak for
  195.      DOS.  Replying "Yes" will invoke an automatic database conversion routine
  196.      that will convert your copied database into the format required by this
  197.      version of DiskTrak for DOS.
  198.  
  199.      Because they contain no directory information, when pre-Version 8.00
  200.      DiskTrak for DOS databases are converted to the current database format,
  201.      all filenames are assumed to be in the diskette's root directory.  However,
  202.      if a file with a comment is actually in a subdirectory, its comment will be
  203.      lost when that diskette is updated by the current version of DiskTrak for
  204.      DOS.  Losing a comment for a file in a subdirectory occurs because DiskTrak
  205.      for DOS Version 8.00 (and later) sees files from earlier version's
  206.      databases as being in the root directory (based on the contents of the
  207.      unconverted database), but when updating the diskette determines the file
  208.      is  actually in a subdirectory.  Thus, it is not recognized as being the
  209.  
  210.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  211.                                         5
  212.  
  213.                                   DiskTrak for DOS
  214.                                     Version 8.00
  215.  
  216.  
  217.      same file and the comment is not carried forward into the updated database. 
  218.      This logic is necessary because DiskTrak for DOS must allow for duplicate
  219.      named files to exist in different directories on the same diskette, and for
  220.      each to have its own unique comment.
  221.  
  222.      The net result of this is that users of versions of DiskTrak for DOS prior
  223.      to Version 8.00 who have entered comments for files in diskette
  224.      subdirectories will have to re-enter them if, and when, they update those
  225.      diskettes with the current version of DiskTrak for DOS.
  226.  
  227.  
  228.                  System Requirements, Compatibility, and Limitations
  229.       
  230.      Beginning with Version 8.00 of DiskTrak for DOS, a mouse or other pointing
  231.      device is highly desired to facilitate selecting the various screen
  232.      elements displayed by the program.  Though a mouse or pointing device is
  233.      not absolutely required, program operation without one is less efficient
  234.      because some screen elements cannot be selected directly, but must be
  235.      tabbed to in a fixed order, or selected using access key combinations.
  236.  
  237.      Primarily because of the ability of DiskTrak for DOS to find duplicate file
  238.      names, many users use DiskTrak to catalog all the files on their hard disk
  239.      (even though DiskTrak was designed for floppy disks.) Depending on the size
  240.      of the hard disk (actually, on the total number of files the disk
  241.      contains), DiskTrak for DOS may be unable to list or report all of them. 
  242.      This is because the program must store in active RAM memory all of the
  243.      filnames in the database so they can be sorted.  DiskTrak attempts to
  244.      determine how much RAM will be required and will issue an error message if
  245.      it finds there is not enough to hold all the file names.  But there may be
  246.      occasions when this fails, so users who catalog large hard disks may be
  247.      unable to produce reports listing the entire database contents.  A "large"
  248.      hard disk is typically one of 100MB or larger size.
  249.  
  250.  
  251.                                   Using the Program
  252.  
  253.      When DiskTrak for DOS starts, several things happen automatically:
  254.  
  255.      (1) If you are using an unregistered version of the program, a Registration
  256.      Motivator dialog box is displayed requiring you to enter the word
  257.      "register".  This step does not occur with a registered copy of the
  258.      program.
  259.  
  260.      (2) The program looks for its configuration file (named DISKTRKD.CFG) and
  261.      reads from it the name of the startup database and various other program
  262.      values (e. g., the color specifications, data disk drive, ZIP option, etc.) 
  263.      If the file DISKTRKD.CFG is not accessible, the default database name
  264.      SAMPLE.DTW is assumed, along with default values for all other items.
  265.  
  266.      Note:  use the Configuration -- Configuration Save option described below
  267.      to create DISKTRKD.CFG.
  268.  
  269.      (3) The program opens the startup database, reads the data in it, and
  270.  
  271.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  272.                                         6
  273.  
  274.                                   DiskTrak for DOS
  275.                                     Version 8.00
  276.  
  277.  
  278.      displays the main menu screen reflecting the data in the database and the
  279.      current program values.  If it is unable to open the startup database, the
  280.      problem may be that it is a database from an earlier version of DiskTrak
  281.      that requires conversion to the current format.  In this case the program
  282.      displays a dialog box asking if you want to convert.  If you select yes,
  283.      the database is converted to the new format, and the old database is saved
  284.      in a file whose name is <name>.DTZ.  If no is selected, the program opens
  285.      the Main Menu, but with no database selected.
  286.  
  287.  
  288.      The following diagram shows the Main Menu command line and all sub-
  289.      commands:
  290.  
  291.      File          Action            Search     Utilities Configuration Help
  292.  
  293.      Open Database Add/Update Disks  Filename   Compress Database       Help
  294.      Dos Shell     Add/Edit Comments Comment    Expand Database         About
  295.      Exit          Report to Screen  Diskname   Make a Database
  296.                    Report to File    Dupe Files Sort by Name
  297.                    Report to Print   Cancel     Sort by Free Space
  298.                    Restore Files      Search    Show Free Space
  299.                    Delete Disks        Results
  300.                    Delete Files
  301.                    Label Disks
  302.  
  303.      In addition to the command line, the DiskTrak for DOS display contains
  304.      seven windows for presenting information.  In clockwise order, starting
  305.      from the upper left, these are:
  306.  
  307.      (1) The disk list window, showing all disks in the current database, the
  308.      amount of free space on each, and the number of files on each.
  309.  
  310.      (2) The file list window, showing all of the files for the disk that is
  311.      currently selected in the disk list window.  The characters <C> after a
  312.      filename in the file list window indicate the file has a comment.
  313.  
  314.      (3) The DiskTrak Messages window, where DiskTrak displays messages about
  315.      its current operation or status.  Initially, this window is blank.
  316.  
  317.      (4) The button box window that contains "push buttons" capable of selecting
  318.      program functions.  This window does double duty by also showing
  319.      information about the current status of DiskTrak for DOS and its database. 
  320.  
  321.      (5) The Comments window, where the comment text is displayed for a file
  322.      that is selected in the file list window (assuming that file has a
  323.      comment.)  If  you selected the  Add/Edit Comment function, this window is
  324.      where you enter/edit comment text.
  325.  
  326.      (6) The Date/Time window that displays the date and time stamp of the file
  327.      currently selected in the file list window.  This window will be blank for
  328.      files in databases converted from an earlier version of DiskTrak for DOS,
  329.      and for files whose names are extracted from archive files. 
  330.  
  331.  
  332.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  333.                                         7
  334.  
  335.                                   DiskTrak for DOS
  336.                                     Version 8.00
  337.  
  338.  
  339.      (7) The Directory window that displays the diskette directory containing
  340.      the file currently selected in the file list window.  For diskettes having
  341.      all files in their root directories, this will be the "\" character only. 
  342.      No directory data is available for files converted from earlier versions of
  343.      DiskTrak for DOS, or for files whose names are extracted from archive
  344.      files.
  345.  
  346.  
  347.                                   The Window Focus
  348.  
  349.      The "Window focus" identifies which screen item will receive input or will
  350.      be used to make a selection.  A screen element "has the focus" when it is
  351.      highlighted or contains the video cursor.  For example, to display the 
  352.      files for a particular disk listed in the disk list window, you must first
  353.      select the disk name.  Doing this is a two step process: (1) causing the
  354.      disk list window to "get the focus", and (2) selecting the desired list
  355.      entry (in this case, disk name.)  In general, you can change the focus to
  356.      different screen objects using one of three techniques:
  357.  
  358.      (1) by pressing the Access Key combination of the screen item you wish to
  359.      have the focus.  A screen item's Access Key combination is the Alt key plus
  360.      the highlighted letter in the item's identifier.  For example, the file
  361.      list's access key is Alt + i.
  362.  
  363.      (2) by using the Tab key to move the focus from one object to the next,
  364.  
  365.      (3) by single-clicking it (the object you want to have the focus) with your
  366.      mouse or pointing device.  
  367.  
  368.      Once you have caused the desired screen element to have the focus, you
  369.      select the desired item by highlighting it using the keyboard direction
  370.      keys (arrow, home, end, pgup, pgdn) or by using your mouse, and then
  371.      selecting it by double clicking you mouse or pointing device, or pressing
  372.      the Enter key.
  373.  
  374.  
  375.                                   Shortcut keys
  376.  
  377.      DiskTrak for DOS supports a capability called Shortcut Keys that allows you
  378.      to invoke selected DiskTrak for DOS functions by simply pressing a single
  379.      key combination; you do not have to select any menu items at all.  As a
  380.      result, you can make selections more quickly by not having to access the
  381.      main menu command line.  Note that using shortcut keys is optional; all of
  382.      the functions in DiskTrak for DOS can be invoked using standard menu
  383.      techniques alone.
  384.  
  385.      Using shortcut keys with DiskTrak for DOS requires knowing which screen
  386.      object has the focus because there are some situations where the same
  387.      shortcut key is used for different functions.  For instance, the Del
  388.      (Delete) key will invoke the Delete Disk function if the disk list window
  389.      has the focus, but will invoke the Delete File function if the file list
  390.      window has the focus.
  391.  
  392.  
  393.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  394.                                         8
  395.  
  396.                                   DiskTrak for DOS
  397.                                     Version 8.00
  398.  
  399.  
  400.      The following table lists all of the DiskTrak for DOS functions that can be
  401.      invoked by shortcut keys, the focus item required, and the key combination
  402.      to use.
  403.  
  404.      Function            Focus Item          Shortcut Key Combination
  405.      -----------------   ----------------    ------------------------
  406.      Add/Update Disks    Disk List window    Ins (Insert)
  407.      Add/Edit Comments   File List window    Ins (Insert)
  408.      Delete Disks        Disk List window    Del (Delete)
  409.      Delete Files        File List window    Del (Delete)
  410.      Restore Files       File List window    Ctrl + R
  411.      Label Disks         Disk List window    Ctrl + L
  412.      Sort Disknames      Disk List window    Ctrl + N
  413.        by Name
  414.      Sort Disknames      Disk List window    Ctrl + F
  415.        by Free Space
  416.      Report to Screen    Disk List window    Ctrl + S
  417.      Report to File      Disk List window    Ctrl + I
  418.      Report to Print     Disk List window    Ctrl + P
  419.  
  420.      Note that (1) each DiskTrak for DOS menu item that can be invoked by a
  421.      shortcut key shows, on its menu "pull down", the shortcut key combination
  422.      in parentheses to the right of the function name, and (2) the shortcut key
  423.      is not always the same as the menu item "selection letter" that is
  424.      highlighhted in the menu function name.  (Remember, you can use the
  425.      selection letter key to selct a menu function once its menu is in view.)
  426.  
  427.  
  428.                           Using the Button Box Push Buttons
  429.  
  430.      The button box window contains eight items, six of which are "push buttons"
  431.      which can invoke program functions.  The other two items are text buttons
  432.      that display program information but are not selectable.  The text buttons
  433.      display the size of the current database and the number of diskettes you
  434.      have entered into the database.
  435.  
  436.      The six push buttons are dual-function; they display current program
  437.      information, and also invoke program functions when selected (clicked). 
  438.      Each function is also selectable via a main menu "pull-down", all of which
  439.      are described in the following sections of this document.  However, here is
  440.      a brief summary of each button:
  441.  
  442.           The Data Drive button displays the current diskette drive DiskTrak for
  443.           DOS will use.  When clicked, this button changes the drive to the next
  444.           one (left button clisk) or previous one (right button click.)  This
  445.           function is also available by selecting the Configuration menu item. 
  446.           You must have a mouse or other pointing device to select this button.
  447.  
  448.           The Database button displays the current database name.  When clicked,
  449.           invokes the Open Database function.  This function is also available
  450.           by selecting  "Open a Database" under the File menu item.
  451.  
  452.           The ZIP button displays the current status of the ZIP extract
  453.  
  454.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  455.                                         9
  456.  
  457.                                   DiskTrak for DOS
  458.                                     Version 8.00
  459.  
  460.  
  461.           function.  When clicked, changes (toggles) the ZIP function between
  462.           off and on.  This function is also available by selecting the
  463.           Configuration menu item.
  464.  
  465.           The Free button displays the percentage of free space in the current
  466.           database.  When clicked, invokes the database compress function which
  467.           is also available by selecting "Compress Database" under the Utilities
  468.           menu item.
  469.  
  470.           The Edit button displays the current status of the Comment Text edit
  471.           function.  When clicked, changes (toggles) the Comment Add/Edit
  472.           function between off and on.  This function is also available by
  473.           selecting "Add/Edit Comments" under the Action menu item (or by using
  474.           its shortcut key.)
  475.  
  476.           The Max button displays the maximum size (number of disks) the current
  477.           database can hold.  When clicked, invokes the Expand Database function
  478.           which is also available by selecting "Expand Database" under the
  479.           Utilities menu item.
  480.  
  481.      The following paragraphs describe the function of each of the menu options
  482.      and, as appropriate, the corresponding operational techniques you should
  483.      use to  optimize your use of DiskTrak for DOS.
  484.  
  485.      FILE
  486.  
  487.      -- Open a Database --
  488.  
  489.      Displays a dialog box allowing you to select the drive and directory from
  490.      which to select DiskTrak for DOS databases.  Note that the data base
  491.      filename pattern is set to *.DTW and cannot be changed.   Change the
  492.      displayed drive and/or directory by selecting it and pressing the Enter
  493.      key, or by double clicking it.
  494.  
  495.      This function can also be invoked by selecting the Database: button in the
  496.      main menu button box.
  497.  
  498.      After DiskTrak for DOS opens the selected database, it fills in the disk
  499.      list window and the program information window.  The disk list window
  500.      contains three columns of data: the diskette name, the amount of free space
  501.      it has, and the number of files on the diskette.  (Free space is displayed
  502.      as xxxK, where K = 1000 bytes, or as xxxM, where M = 1,000,000 bytes.)  To
  503.      see the names of the files on any particular diskette, simply select the
  504.      diskette's name and DiskTrak for DOS will fill the file list window with
  505.      the names of the files it contains.  You can scroll through the disk names
  506.      and file names using the mouse or the Up/Down, PgUp/ PgDn, and Home/End
  507.      keys.  File names for which you have added comments have the characters
  508.      "<C>" after their names.  (See the Action  Add/Edit Comments section for
  509.      how to create comments.)  Selecting a file name causes its date and  time
  510.      stamp data to appear in the Date/Time text box, and  its diskette directory
  511.      name to appear in the Directory text box.  If the file has a comment, it is
  512.      displayed in the Comment box.
  513.        
  514.  
  515.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  516.                                         10
  517.  
  518.                                   DiskTrak for DOS
  519.                                     Version 8.00
  520.  
  521.  
  522.      -- DOS Shell --
  523.  
  524.      Selecting this option causes DiskTrak for DOS to start a "child" DOS shell. 
  525.      This means DiskTrak for DOS will appear to end and return control to DOS. 
  526.      In fact, DiskTrak for DOS is still active (in your computer's memory), but
  527.      has invoked the DOS command processor allowing you to issue any command you
  528.      would when running under DOS alone.  From the DOS shell you can copy files,
  529.      initialize disks, invoke other programs, etc.  However, you MUST remember
  530.      to return to DiskTrak for DOS by entering the command "Exit" when you have
  531.      finished with your DOS functions. 
  532.  
  533.      Note:  when in the DOS shell, do not move, rename, or otherwise disturb the
  534.      DiskTrak for DOS database or configuration file.  Changes made to these
  535.      files while in the DOS shell would be unknown to DiskTrak for DOS, and
  536.      unpredictable (probably bad) results would occur when DiskTrak for DOS
  537.      resumes.
  538.  
  539.                               
  540.      -- Exit --
  541.  
  542.      Selecting this option ends DiskTrak for DOS and returns you to the standard
  543.      DOS prompt. As the closing screen indicates, if you use DiskTrak for DOS on
  544.      a regular basis you are obligated to send the $25.00 (US) registration fee
  545.      to Peninsula Software.
  546.  
  547.  
  548.      ACTION
  549.  
  550.  
  551.      -- Add/Update Disk(s) --
  552.  
  553.      Shortcut key: Ins (Insert)
  554.  
  555.      Selecting this option allows you to enter diskettes into the DiskTrak for
  556.      DOS database.  The diskettes you enter can be either new diskettes, i. e.,
  557.      ones not currently in the database, or a re-entering (called a "refresh")
  558.      of a diskette currently in the database.  After selecting this option
  559.      DiskTrak for DOS will ask you to insert the diskette into the Data Disk
  560.      Drive and press Enter when ready.  DiskTrak for DOS will then attempt to
  561.      read the diskette's internal label (sometimes called the volume ID.)  If
  562.      there is no internal label, DiskTrak for DOS will ask you to enter one. 
  563.      This label will be used by DiskTrak for DOS to identify the diskette in its
  564.      database and will also be automatically written onto the diskette.  (See
  565.      the Label Disk section below for details on the labeling process.) 
  566.      DiskTrak for DOS will then check to see if the diskette is already
  567.      contained in the database.  If not, DiskTrak for DOS will read all the
  568.      filenames in each directory on the disk, alphabetically sort each
  569.      directory's filenames, and store them in the database.  It also stores the
  570.      total amount of free space on the disk in the database.  If you specified
  571.      the "ZIP" option to be enabled, DiskTrak for DOS will extract all filenames
  572.      from inside archive files of type ZIP, PAK, ARC, LZH, or ZOO. 
  573.  
  574.      If the diskette is already in the DiskTrak for DOS database you will be
  575.  
  576.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  577.                                         11
  578.  
  579.                                   DiskTrak for DOS
  580.                                     Version 8.00
  581.  
  582.  
  583.      asked if you want to proceed and "refresh" the database information. 
  584.      Normally you will want to do this, because (presumably) you have added or
  585.      deleted files from the diskette, and you want its current status reflected
  586.      in the DiskTrak for DOS database.  However, if you have inadvertently
  587.      created two different diskettes with the same name, you can abort the
  588.      Add/Update function at this time, relabel the diskette, and proceed again.
  589.  
  590.      DiskTrak for DOS will process only normally formatted DOS diskettes, and
  591.      will reject an unformatted diskette, or a diskette with a non-standard
  592.      format, such as those created by some hard disk backup programs.  
  593.  
  594.      Usage hint: you can invoke the Add/Update function by simply pressing the
  595.      Ins (Insert) key any time the disk list window has the current focus. 
  596.      Doing this is quicker than selecting the Add/Update function from the
  597.      Action menu item.
  598.  
  599.  
  600.      -- Add/Edit Comments --
  601.  
  602.      Shortcut key: Ins (Insert)
  603.  
  604.      This menu option is a toggle that successively enables and disables the
  605.      ability to add or edit filename comments.  When this option is enabled
  606.      there is a check mark next to the Add/Edit Comments text in the menu and
  607.      the Edit button will display as a depressed, yellow-highlighted (lit up)
  608.      button with its caption changed from "Off" to "On".  When the function is
  609.      disabled the check is removed and the Edit button returns to "Off" status.
  610.  
  611.      This function can also be invoked by selecting the Edit button in the main
  612.      menu button box.
  613.  
  614.      When Add/Edit Comments is enabled the text editing cursor will
  615.      automatically appear in the Comment window after selecting a file in the
  616.      file list window.   You can then proceed to enter and/or edit comment text. 
  617.      Use the Return key to tell DiskTrak for DOS you have finished your edit. 
  618.      When you press Return, the text in the comment window will be assigned to
  619.      the currently selected file name.   You can then proceed to select another
  620.      file name from the file list window for comment editing.
  621.  
  622.      You can delete an existing comment by deleting all its text.
  623.  
  624.      When this function is diabled it is not possible to select the comment
  625.      window, and consequently not possible to add or edit comment text. 
  626.      DiskTrak for DOS starts with this function disabled, but you can enable and
  627.      disable it whenever you like.
  628.  
  629.      Usage hint: you can invoke the Add/Edit Comment function by simply pressing
  630.      the Ins (Insert) key any time the file list window has the current focus. 
  631.      Doing this is quicker than selecting the Add/Edit Comment function from the
  632.      Action menu item.
  633.  
  634.  
  635.  
  636.  
  637.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  638.                                         12
  639.  
  640.                                   DiskTrak for DOS
  641.                                     Version 8.00
  642.  
  643.  
  644.      -- Report to Screen --
  645.  
  646.      Shortcut key: Ctrl + S
  647.  
  648.      DiskTrak for DOS can produce any of five types of reports (see the
  649.      Configuration - Report Type option below for details) summarizing its
  650.      database contents.  The Report to Screen option will report the contents of
  651.      the current database to the screen.  All of the report types except type 3
  652.      use a single window dialog box.  Report Type 3 (filenames and comments)
  653.      uses a two window dialog box: the first displays the filenames and the
  654.      first few words of the comment.  Selecting a filename with a comment in
  655.      this window will cause the entire comment text to be displayed in the lower
  656.      (second) window.  To see all the text of a very long comment, use the
  657.      scroll bars on the right of the comment text window.  
  658.  
  659.      Select the Close button at the bottom of the DiskTrak Screen Report window
  660.      to close it and return to the main menu window.
  661.  
  662.      Note: due to a Visual Basic limitation, it may not be possible for the
  663.      Report to Screen option to display all of the data in the current database. 
  664.      In this event, DiskTrak for DOS will display as much as it can, and also
  665.      issue a message indicating you should use the Report to File or Report to
  666.      Print option (described below) to obtain the entire database contents.
  667.  
  668.  
  669.      -- Report to File --
  670.  
  671.      Shortcut key: Ctrl + I
  672.  
  673.      This option directs the selected report to a disk file named <name>.RPT
  674.      (where <name> is the name of the current DiskTrak for DOS database) that is
  675.      created in the default directory.  The format of the report file is as
  676.      specified in the  Report Type option below.   This option allows you to
  677.      store the report output on disk and view it with some utility text viewing
  678.      program (or the DOS "TYPE" command), and then decide if you want to print
  679.      it by copying the file <name>..RPT to a printer.  This option creates no
  680.      printer or screen output.
  681.  
  682.  
  683.      -- Report to Print --
  684.  
  685.      Shortcut key: Ctrl + P
  686.  
  687.      This option causes DiskTrak for DOS to send its report directly to your
  688.      printer.   When you make this selection, DiskTrak for DOS directs its
  689.      report output to the device attached to your computer's LPY1 port.
  690.  
  691.  
  692.      -- Restore Files --
  693.  
  694.      Shortcut key: Ctrl + R
  695.  
  696.      This option allows you to select a file from the DiskTrak for DOS database
  697.  
  698.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  699.                                         13
  700.  
  701.                                   DiskTrak for DOS
  702.                                     Version 8.00
  703.  
  704.  
  705.      and have it copied from its diskette to a hard disk directory you specify. 
  706.      This function is typically called "restoring".
  707.        
  708.      Before selecting this function you should first select the file your want
  709.      to restore from the file list window.  Then, when you select the Restore
  710.      FIles option, DiskTrak for DOS will display a dialog window titled "Restore
  711.      from Floppy to Hard Disk".  This window identifies the name of the file
  712.      your have selected for restoring, the name of the diskette containing it,
  713.      status of the restore operation, and a drop-down drive list box and a
  714.      directory list box that allow you to select the disk and directory to which
  715.      to restore the selected file.  Finally, there is a text box that displays
  716.      the path (disk and directory) you have selected for the restore operation,
  717.      and two command buttons: Restore and Close.
  718.  
  719.      Use the drive and directory list boxes to select the restore path (remember
  720.      to double-click on the desired directory to select it.)    After selecting
  721.      the desired disk and directory, select the Restore button.  DiskTrak for
  722.      DOS will then ask if you really want to proceed with the restore operation. 
  723.      Selecting OK will allow the restore to proceed; selecting Cancel returns
  724.      you to the Restore From Floppy To Hard Disk Window.  Selecting the Close
  725.      button on the the Restore From Floppy To Hard Disk Window will close this
  726.      window and return you to the main menu window.
  727.  
  728.      Before initiating the restore function you should put the required diskette
  729.      into the Data Disk drive.
  730.  
  731.      If you select OK and initiate the restore function, DiskTrak for DOS will
  732.      attempt to copy the selected file from the diskette you have put in the
  733.      Data Disk Drive to the selected path (drive and directorty.)  Status of the
  734.      restore operation will be reflected in the Status of Restore text box and
  735.      in the main menu message window.  
  736.  
  737.      If DiskTrak for DOS is unable to locate the selected file, the message
  738.      "Can't open source or target files.  Wrong disk?" appears in the status
  739.      window.  You can then insert a different diskette (if you inadvertently
  740.      inserted the wrong one), select another file for restoring , or select the
  741.      Cancel button, which closes the "Restore from Floppy to Hard Disk" window
  742.      and returns you to the main menu window.
  743.  
  744.  
  745.      -- Delete Disks --
  746.  
  747.      Shortcut key: Del (Delete)
  748.  
  749.      This option allows you to delete one or more diskettes from the current
  750.      database.  You would want to do this if, for instance, you decided to
  751.      re-use a diskette for a different purpose and had given it a new internal
  752.      label and a new set of files.  Note that if you keep the same internal
  753.      diskette name (volume label) and merely replace all the files on it there
  754.      is no need to delete the diskette name from the current database.  Instead,
  755.      simply use the Add/Update function described above to "refresh" the
  756.      database with the diskette's current status.
  757.  
  758.  
  759.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  760.                                         14
  761.  
  762.                                   DiskTrak for DOS
  763.                                     Version 8.00
  764.  
  765.  
  766.      Selecting this option displays a warning message telling you that you have
  767.      enabled "Delete Disks" mode.  You can select OK or Cancel.  If OK is
  768.      selected, DiskTrak for DOS places a check mark next to the Delete Disks
  769.      menu text and displays a message telling you that you are in Delete Disks
  770.      mode.  From then on, each time you select a disk from the disk list window,
  771.      DiskTrak for DOS will ask you if you want to delete it from the database. 
  772.      Selecting the Yes button will delete it from the data base; selecting No
  773.      will not.  
  774.  
  775.      Return to non-Delete Disks mode by re-selecting the Delete Disks function
  776.      -- it toggles the Delete Disks mode on and off.
  777.  
  778.      Usage hint: you can invoke the Delete Disks function by simply pressing the
  779.      Del (Delete) key any time the disk list window has the current focus. 
  780.      Doing this is quicker than selecting the Delete Disks function from the
  781.      Action menu item.
  782.  
  783.  
  784.      -- Delete Files --
  785.  
  786.      Shortcut key: Del (Delete)
  787.  
  788.      This option allows you to physically delete one or more files from your
  789.      diskettes.  
  790.  
  791.      WARNING:   THE SELECTED FILES WILL ACTUALLY BE DELETED FROM YOUR DISKETTES, 
  792.      NOT SIMPLY REMOVED FROM THE DISKTRAK DATABASE.  
  793.  
  794.      This option exists to make it easy to "clean up" your diskettes; you can
  795.      easily delete unwanted and/or duplicate files using this option.  (You can
  796.      also delete files you really want to keep if you are not careful!)
  797.  
  798.      Selecting this option displays a warning message telling you that you have
  799.      enabled "Delete Files" mode.  You can select OK or Cancel.  If OK is
  800.      selected, DiskTrak for DOS places a check mark next to the Delete Files
  801.      menu text and displays a message telling you that you are in Delete Files
  802.      mode.  From then on, each time you select a file from the file list window,
  803.      DiskTrak for DOS will ask you if you want to delete the selected file. 
  804.      Selecting the Yes button will cause the program to check that the required
  805.      diskette is in the data disk drive (if not, you will be asked to insert
  806.      it), delete the specified file from it, and then automatically update the
  807.      DIskTrak data base.  Selecting No will not delete the file (and return you
  808.      to the main menu window.)  
  809.  
  810.      Return to non-Delete Files mode by re-selecting the Delete Files function
  811.      -- it toggles the Delete Disks mode on and off.
  812.  
  813.      There two major reasons why DiskTrak for DOS may not be able to actually
  814.      delete a selected file: (1) the file may actually not be on the diskette
  815.      (it was deleted by some other program after the diskette was added to the
  816.      DiskTrak for DOS database),  or (2) the file was found on a disk that was
  817.      write protected, and consequently could not be deleted.
  818.  
  819.  
  820.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  821.                                         15
  822.  
  823.                                   DiskTrak for DOS
  824.                                     Version 8.00
  825.  
  826.  
  827.      -- Label Disks --
  828.  
  829.      Shortcut key: Ctrl + L
  830.  
  831.      This option lets you label (or re-label) a diskette from within DiskTrak
  832.      for DOS, thus eliminating the need to shell to DOS and use the DOS LABEL
  833.      command.  When you select this option DiskTrak for DOS will ask you to put
  834.      a diskette in the data disk drive.  It will then attempt to read the
  835.      internal label from the disk.  If there is no label  DiskTrak for DOS will
  836.      ask you to enter one.  If there already is a label on the disk, DiskTrak
  837.      for DOS displays a message showing the current label and asks you if you
  838.      want to re-label the disk.  If so, enter the new label.  When you have
  839.      finished labeling disks simply select the Cancel button to return to the 
  840.      main menu screen.  
  841.  
  842.      Note:  DiskTrak for DOS checks the label you enter for valid characters and
  843.      will reject one that is invalid.  DiskTrak for DOS displays an error
  844.      message in this case.  The entered label is also checked to see if it
  845.      duplicates the label of a disk in the current database.  If so, you are
  846.      queried whether or not you want to use it or enter a new one.  (Suggestion
  847.      -- use a different label to avoid duplicate diskette names.)
  848.  
  849.      Usage hint: you can invoke the  Label Disks function by simply pressing the
  850.      "L" key any time the disk list window has the current window focus.  Doing
  851.      this is quicker than selecting the Label Disks function from the Action
  852.      menu item.
  853.  
  854.  
  855.      SEARCH
  856.  
  857.      The search functions are the primary reason DiskTrak for DOS was written.
  858.        
  859.      These functions allow you to search for a particular disk volume, file
  860.      name, or file comment.  In addition, DiskTrak for DOS can identify all
  861.      duplicate files in its database.
  862.  
  863.      The disk, file, and comment search functions allow you to enter a search
  864.      argument (called the search text) consisting of a complete or partial disk
  865.      name, file name, or comment, and have DiskTrak for DOS search its entire
  866.      database for all diskettes and/or files that match your search text. When
  867.      searching, DiskTrak for DOS does not differentiate between upper and lower
  868.      case letters; they are considered the same.  Also, note that the search
  869.      functions employ literal searches based on the exact set of characters you
  870.      enter.  The special DOS wildcard characters * and ? are not recognized as
  871.      wildcards, and should not be used in the search string.
  872.  
  873.      Each of the text search functions works similarly: selecting any one
  874.      results in the display of a dialog box requesting entry of the search text. 
  875.      After you enter the search text and select the OK button, DiskTrak for DOS
  876.      searches the database for all matches.   While searching it displays a
  877.      message telling you how many names are being searched and what the search
  878.      text is.
  879.  
  880.  
  881.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  882.                                         16
  883.  
  884.                                   DiskTrak for DOS
  885.                                     Version 8.00
  886.  
  887.  
  888.      The function that searches for duplucate file names requires no input; when
  889.      selected it immediately searches the curent database for all duplicate file
  890.      names.
  891.  
  892.      When the search is finished, DiskTrak for DOS updates the disk list window
  893.      to show only those disks who match the search text (if you requested a disk
  894.      name search), or that contain files with names or comments matching the
  895.      search text (in the case of a disk name or comment search, respectively),
  896.      or that contain files with names duplicated on other disks.  Selecting one
  897.      of the disk names in the disk list window will display, in the file list
  898.      window, only those files who match the search text, or only those files
  899.      that have names the same as others.  In other words, following a search,
  900.      DiskTrak for DOS displays only the information matching the search
  901.      criteria.
  902.  
  903.      Note: After you have examined the results of your search you will want to
  904.      return to "normal mode" and enable DiskTrak for DOS to display the entire
  905.      database contents.  Use the Cancel Search Results selection to do this.
  906.  
  907.  
  908.      -- Filename --
  909.  
  910.      DiskTrak for DOS will display a dialog box asking you to enter the search
  911.      text.  The current database will then be searched for all disks containing
  912.      files whose names contain the search text.  When the search is complete
  913.      DiskTrak for DOS will display these disk names (and only these disk names)
  914.      in the disk list window.
  915.  
  916.  
  917.      -- Comment --
  918.  
  919.      DiskTrak for DOS will display a dialog box asking you to enter the search
  920.      text.  The current database will then be searched for all disks containing
  921.      files that have comments that contain the search text.  When the search is
  922.      complete DiskTrak for DOS will display these disk names (and only these
  923.      disk names) in the disk list window.
  924.  
  925.  
  926.      -- Diskname --
  927.  
  928.      DiskTrak for DOS will display a dialog box asking you to enter the search
  929.      text.  The current database will then be searched for all disks whose names
  930.      contain the search text.  When the search is complete DiskTrak for DOS will
  931.      display these disk names (and only these disk names) in the disk list
  932.      window.
  933.  
  934.  
  935.      -- Duplicate Files --
  936.  
  937.      When you select this function DiskTrak for DOS reads all of the file names
  938.      in the current database, sorts them alphabetically, and then searches the
  939.      names for duplicates.  When the search operation is complete, DiskTrak for
  940.      DOS shows in the disk list window only the disk names that contain
  941.  
  942.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  943.                                         17
  944.  
  945.                                   DiskTrak for DOS
  946.                                     Version 8.00
  947.  
  948.  
  949.      duplicate files.  Selecting one of these disk names will display in the
  950.      file list window the file names that were also found on other disks.
  951.  
  952.  
  953.      -- Cancel Search Results --
  954.  
  955.      This option cancels "search mode", which displays in the disk and file list
  956.      windows ONLY those items matching the search text, and restores "normal
  957.      mode", which allows ALL disk and file names to be displayed.
  958.  
  959.      You should be sure to select this option after reviewing the results of
  960.      your search operation so that DiskTrak for DOS can display all of the
  961.      information in the data base, and not just that that matches the seaarch
  962.      text.
  963.  
  964.  
  965.      UTILITIES
  966.  
  967.      -- Compress Data --
  968.  
  969.      Selecting this option causes DiskTrak for DOS to remove all of the unused
  970.      space from the current database.  To do this, DiskTrak for DOS creates a
  971.      new database for itself, copies all of the current database information to
  972.      it, deletes the old one, and renames the new one to the same name as the
  973.      old.  When this operation finishes there will be 0% free space in the
  974.      DiskTrak for DOS database.
  975.  
  976.      This function can also be invoked by selecting the Free: button in the main
  977.      menu button box.
  978.  
  979.      Note: in order for this function to work there must be sufficient free
  980.      space on the disk with the default directory to accommodate a second file
  981.      equal in size to the current DiskTrak for DOS database.       
  982.  
  983.  
  984.      -- Expand Data --
  985.             
  986.      Select this option if you have to add more disks to your database than it
  987.      was originally specified to hold.  After choosing this option DiskTrak for
  988.      DOS will ask you for the number of diskettes in the expanded database.  You
  989.      should enter the new TOTAL number of diskettes desired, NOT the increase
  990.      (delta) over the current number.  After entering this new total, DiskTrak
  991.      for DOS will create a database capable of holding the specified number of
  992.      disks, and will then copy all of the data in your current database to the
  993.      newly expanded one.  When this is complete, DiskTrak for DOS will delete
  994.      your current database and rename the new one to your "old" current database
  995.      name.  The new, expanded database will also be compressed, i. e., it will
  996.      have 0% free space. 
  997.  
  998.      This function can also be invoked by selecting the button showing the
  999.      current maximum number of diskettes in the main menu button box.
  1000.  
  1001.  
  1002.  
  1003.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1004.                                         18
  1005.  
  1006.                                   DiskTrak for DOS
  1007.                                     Version 8.00
  1008.  
  1009.  
  1010.      -- Make a Database --
  1011.             
  1012.      Use this option to create your own DiskTrak for DOS database(s).  You can
  1013.      have any number of databases, but only one can be in use at a time. 
  1014.      Multiple databases may be desired, for instance, if there are several
  1015.      people using your computer and each has his/her own set of diskettes.  Or,
  1016.      you may have so many diskettes that you want to logically segregate them
  1017.      into groups.
  1018.             
  1019.      To create a DiskTrak for DOS database, select this option and specify the
  1020.      name of the database and the number of diskettes you want it to hold.  When
  1021.      specifying the database name, enter only the 1 to 8 character primary
  1022.      extension.  (Because all DiskTrak for DOS databases must have a name of the
  1023.      form <name>.DTW, DiskTrak for DOS will automatically add the extension
  1024.      ".DTW" to the name you enter.)  When specifying the number of diskettes the
  1025.      database should hold, enter a reasonable number.  You can always increase
  1026.      it later by using the Expand function described above.
  1027.  
  1028.      After specifying the database name and number of diskettes it is to hold,
  1029.      select the OK button to cause DiskTrak for DOS to create the database. 
  1030.      Select the Cancel button to cancel this fiunction and return to the main
  1031.      program window with no action.
  1032.  
  1033.      The database created by this option will (obviously) be empty.  Add
  1034.      diskettes to it by first selecting the new database  by using the File -
  1035.      Open a Database function, and then invoking the Action - Add/Update Disk
  1036.      option.
  1037.  
  1038.      Note: since there is no way to reduce the size of a DiskTrak for DOS
  1039.      database you should avoid specifying a total number of disks significantly
  1040.      larger than you are likely to need.  You can always expand your database
  1041.      later.
  1042.  
  1043.  
  1044.      -- Sort Disknames by Name --
  1045.  
  1046.      Shortcut key: Ctrl + N
  1047.  
  1048.      In general, DiskTrak for DOS displays diskettes entered into its database
  1049.      in the order in which they are entered.  The Sort Disknames by Name option
  1050.      lets you change the order of the display to alphabetical.  New diskettes
  1051.      will continue to be added in the order entered, and will not be listed in
  1052.      alphabetical order unless you re-sort the entire list of names using this
  1053.      option.
  1054.  
  1055.  
  1056.      -- Sort Disknames by Free Space --
  1057.  
  1058.      Shortcut key: Ctrl + F
  1059.  
  1060.      This option is similar to the above one, except the list of disks is sorted
  1061.      by available free space.  The disk with the least free space is listed
  1062.      first.  Disks with unknown free space (showing "?K") are listed last; these
  1063.  
  1064.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1065.                                         19
  1066.  
  1067.                                   DiskTrak for DOS
  1068.                                     Version 8.00
  1069.  
  1070.  
  1071.      are disks from a database that was copied from a DOS DISKTRAK.EXE
  1072.      <name>.DT7 database and that have not yet been entered into the current
  1073.      database by this version of DiskTrak for DOS.
  1074.  
  1075.  
  1076.      -- Show Free Space --
  1077.  
  1078.      This option shows you the amount of free space on a diskette.  After
  1079.      selecting this option DiskTrak for DOS will ask you to insert a diskette
  1080.      into the Data Disk Drive.  After doing so, select the OK button and
  1081.      DiskTrak for DOS will read the label of the diskette, determine its total
  1082.      free space (in K bytes, where K = 1000) and display a message containing
  1083.      this information.  DiskTrak for DOS will then repeat this process until you
  1084.      select the Cancel button to return to the main menu.
  1085.  
  1086.  
  1087.      CONFIGURATION
  1088.  
  1089.      Selecting this menu item displays a dialog window that allows you to view,
  1090.      change, and save DiskTrak for DOS' configuration items.  The following
  1091.      paragraphs describe the selectable items in the Configuration dialog
  1092.      window.
  1093.  
  1094.      -- OK --
  1095.  
  1096.      Retains the currently set configuration items, closes the Configuration
  1097.      window, and returns you to DiskTrak for DOS' main program window.  If you
  1098.      changed any of the configuration items they will be in effect for your
  1099.      current session only; you must select the Save button below to make them
  1100.      permanent.
  1101.  
  1102.      -- Save --
  1103.  
  1104.      This button creates (if it does not already exist) or updates (if it does
  1105.      exist) a file in the default directory called DISKTRKD.CFG and writes into
  1106.      it all of the current DiskTrak for DOS configuration parameters.  These
  1107.      parameters include the current color specifications, the DiskTrak for DOS
  1108.      database name, the diskette drive to use when reading diskettes, the number
  1109.      of lines per report page, the desired report type, and the ZIP status
  1110.      (enabled or disabled).  
  1111.  
  1112.      You should use this function to retain any new or changed program settings
  1113.      from one session to the next.
  1114.  
  1115.  
  1116.      -- Data Disk Drive --
  1117.  
  1118.      This option allows you to specify the diskette drive DiskTrak for DOS will
  1119.      use for reading diskettes.  The default diskette drive is A:, but you can
  1120.      change it to any drive letter A: through P:.  DiskTrak for DOS will reject
  1121.      a drive "letter" that is not a character in the range A -- P.  You can
  1122.      enter either an upper or lower case letter (no colon).        
  1123.  
  1124.  
  1125.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1126.                                         20
  1127.  
  1128.                                   DiskTrak for DOS
  1129.                                     Version 8.00
  1130.  
  1131.  
  1132.      You can also change the data disk drive by selecting the Data Drive: 
  1133.      button in the main menu button box.  Selecting this button with the left
  1134.      mouse button increases the drive letter by one; selecting with the right
  1135.      button decreases it by one.
  1136.  
  1137.  
  1138.      -- ZIP Extract --
  1139.  
  1140.      This option lets you specify whether or not DiskTrak for DOS is to extract
  1141.      the names of files stored inside an archive file of type ZIP, ARC, PAK,
  1142.      LZH, or ZOO.  The default is NOT to do this.  If you select this option the
  1143.      ZIP button will display as a depressed, yellow-highlighted (lit up) button,
  1144.      and its caption will change from "No" to "Yes".  DiskTrak for DOS will then
  1145.      add to its database, in addition to the base ZIP, ARC, PAK, LZH, or ZOO
  1146.      archive file name, all of the file names contained inside each one.  Note
  1147.      that if you enable this function and then add to the DiskTrak for DOS
  1148.      database one or more disks containing numerous archive files, the size of
  1149.      your database will get very large very quickly.
  1150.  
  1151.      To turn the ZIP option off, simply reselect it; it is a "toggle."  This
  1152.      function can also be invoked by selecting the ZIP: button in the main menu
  1153.      button box.
  1154.  
  1155.      The "ZIP" status is saved in the DiskTrak for DOS DISKTRKW.CFG file, so if
  1156.      you want it always enabled, enable it and then select the Save button.
  1157.  
  1158.  
  1159.      -- Print Lines/Page --
  1160.  
  1161.      This option lets you specify the number of lines DiskTrak for DOS will
  1162.      place on its output reports.  These reports can be sent either directly to
  1163.      your printer or to a disk file: see the Action -- Report  options above. 
  1164.      Because of the title and page number lines DiskTrak for DOS prints on each
  1165.      report page, the number of lines per page must be at least 7.  The Print
  1166.      Lines/Page option has no effect on reports directed to the screen.  You can
  1167.      retain the number you specify in the DISKTRKW.CFG configuration file (make
  1168.      it permanent) by selecting the Save button.
  1169.  
  1170.  
  1171.      -- Report Type --
  1172.  
  1173.      DiskTrak for DOS can create five types of reports that summarize the
  1174.      information in its database.  Report type 1 lists all files in the database
  1175.      and the diskette name each file is on, sorted alphabetically by filename. 
  1176.      Report type 2 contains the same information, but sorts it by diskette
  1177.      volume name.  Report type 3 lists every filename and its comment (if
  1178.      present); this report is sorted by filename.  Report type 4 lists each disk
  1179.      and its free space, sorted by disk name.  Report type 5 is like type 4,
  1180.      except the sort is by amount of free space.
  1181.  
  1182.      Specify the desired Report Type by selecting the appropriate button.  The
  1183.      selected button will have a yellow background color. You can retain the
  1184.      selected report type by selecting the Save button.
  1185.  
  1186.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1187.                                         21
  1188.  
  1189.                                   DiskTrak for DOS
  1190.                                     Version 8.00
  1191.  
  1192.  
  1193.      -- Screen Colors --
  1194.             
  1195.      This command button lets you set the window and dialog box colors for
  1196.      DiskTrak for DOS.  When you select this button, DiskTrak for DOS
  1197.      temporarily hides the Configuration dialog window and displays the color
  1198.      control window.  This window contains a set of color controls, a sample
  1199.      color area, a "model" of the DiskTrak for DOS main screen, a series of
  1200.      "radio buttons" allowing you to select the window element(s) for which you
  1201.      want to set the colors, and two command buttons that let you apply the new
  1202.      colors and return to the Configuration dialog window.  To set colors, use
  1203.      the following steps:
  1204.  
  1205.      (1)  Use the "Select Screen Element..." radio buttons to select the screen
  1206.      element you want to alter.  Note that the selected item's name is reflected
  1207.      in the "Now setting colors for" text window.
  1208.  
  1209.      (2)  Use the "Foreground/Background" radio buttons to specify whether you
  1210.      are about to set the foreground (text) color or background color. 
  1211.      Suggestion: set the background color first, then the foreground color.
  1212.  
  1213.      (3)  Use the arrow keys (or mouse) to choose from the color matrix of  the
  1214.      standard DOS pallette of 16 colors the color you want the previously
  1215.      selected screen element to have.  As you choose different colors from the
  1216.      matrix the color of the small window immediately above the color matrix
  1217.      will change to reflect the current color matrix selection.
  1218.  
  1219.      (4)  When you have established the desired color, select the OK button. 
  1220.      This will apply the color to the previously selected screen element.  The
  1221.      appropriate color in the "model" window in the upper right corner will
  1222.      change to reflect the new color scheme.  This action also changes the
  1223.      "real" screen elements.
  1224.  
  1225.      (5)  Repeat steps (1) -- (4) until all the screen elements are colored they
  1226.      way you want them.
  1227.  
  1228.      (6)  Select the Close button to close the color setting window and return
  1229.      to the Configuration dialog window.
  1230.  
  1231.      Note: your new color scheme will only be in effect for your current session
  1232.      and will NOT be retained permanently UNLESS you perform a Configuration
  1233.      Save function by selecting the Configuration menu's Save button
  1234.  
  1235.  
  1236.      HELP
  1237.  
  1238.      -- Help --
  1239.  
  1240.      Selecting Help will display a two-window dialog box that contains an index
  1241.      of Help topics on the left and Help text on the right.  Selecting a topic
  1242.      causes the text for that topic to display at the top of the text window. 
  1243.      You can scroll through either the index or text window using the scroll
  1244.      bars, PgUp/PgDn keys, arrow keys, etc.  When you have finished reading the
  1245.      Help text, select the Return to DiskTrak button to close the Help dialog
  1246.  
  1247.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1248.                                         22
  1249.  
  1250.                                   DiskTrak for DOS
  1251.                                     Version 8.00
  1252.  
  1253.  
  1254.      box.
  1255.  
  1256.  
  1257.      -- About --
  1258.  
  1259.      If you are using a non-registered copy of DiskTrak for DOS, selecting this
  1260.      option displays a "Registration Motivator" dialog box that requires you to
  1261.      enter the word "register".  After doing so, a message window is displayed
  1262.      giving some information about the program and how to contact the program
  1263.      author.
  1264.  
  1265.      If you are using a registered version of the program, the "Registration
  1266.      Motivator" dialog box does not appear, and the message window displays the
  1267.      name of the person to whom the program is registered, along with the other
  1268.      program related information.
  1269.  
  1270.  
  1271.                                  Future Enhancements
  1272.  
  1273.      Additional enhancements will be developed depending on the degree of
  1274.      interest and support received by the current version of DiskTrak for DOS. 
  1275.      Peninsula Software will seriously consider any enhancements suggested by
  1276.      registered users.  For example, the report option was added as a result of
  1277.      a suggestion (and sample source code) from Joseph R. Nelis, Jr. (thanks,
  1278.      Jody!) and the comments option resulted from a suggestion by L. P.
  1279.      Thomason.  
  1280.  
  1281.  
  1282.                             The DiskTrak for DOS Database
  1283.  
  1284.      The distribution DiskTrak for DOS files contain a "sample" database called
  1285.      SAMPLE.DTW.   This database contains information from a small set of disks
  1286.      and includes comments containing helpful information about using DiskTrak
  1287.      for DOS.  When DiskTrak for DOS starts, it first checks to see if a
  1288.      configuration file exists.  (See above section CONFIGURATION --
  1289.      Configuration Save for more information on creating the configuration
  1290.      file.)  If there is a configuration file, DiskTrak for DOS attempts to use
  1291.      the database defined in it.  If there is no configuration file, DiskTrak
  1292.      for DOS attempts to use a database called SAMPLE.DTW.  In either case, if
  1293.      DiskTrak for DOS cannot open or read the database file, it returns to the
  1294.      main menu with an error message stating it was unable to access the
  1295.      selected database and requests you to select a different one.
  1296.  
  1297.      The DiskTrak for DOS database contains the names of all the diskettes you
  1298.      have entered, the amount of free space on each, all of the file names on
  1299.      all diskettes, and all of the comments you enter.  Beginning with Version
  1300.      8.00, the database was enhanced to also contain date and time stamp data
  1301.      for each file, and the name of the diskette directory containing each file. 
  1302.      There are pointers in the database that connect a diskette to its files,
  1303.      and files to their comments (if present).  Finally, there are  counters
  1304.      holding the total number of diskettes in the database, the number of "free"
  1305.      file names, and the number of "free" comment characters.  "Free" filenames
  1306.      result from files being deleted from diskettes, or from diskettes being
  1307.  
  1308.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1309.                                         23
  1310.  
  1311.                                   DiskTrak for DOS
  1312.                                     Version 8.00
  1313.  
  1314.  
  1315.      deleted from the database.  "Free" comment bytes result from files with
  1316.      comments being deleted from the database, or by creating new (edited)
  1317.      comments that are longer than the original comment.
  1318.  
  1319.      The latter two numbers are what determine the "free space" in the data
  1320.      base.  Free space results from deleting a diskette from the database, or
  1321.      from "refreshing" a diskette already existing in the database.  In either
  1322.      of these two cases, the filenames previously used are flagged as "free" and
  1323.      are no longer usable.  (Comments are maintained intact, however, if the
  1324.      filename with the comment is still on the updated disk.)  All updates
  1325.      and/or additions to the database are made at the end of the database. 
  1326.      Consequently, as time goes on, unwanted "free space" will build up inside
  1327.      the database.  This "free space" is reported in the DiskTrak for DOS
  1328.      program information window in terms of a percentage of the size of the
  1329.      entire database.  This "free space" is literally unusable, wasted space and
  1330.      should be eliminated when it becomes excessive.
  1331.             
  1332.      The "Compress Data" option under the Utilities selection will eliminate all
  1333.      "free space" from your database.  See the section describing that option
  1334.      for more detail.
  1335.  
  1336.  
  1337.                                    Version History
  1338.  
  1339.      Version 8.00
  1340.  
  1341.      Version 8.00 is the initial release of DiskTrak for DOS that is based on
  1342.      Peninsula SOftware's DiskTrak for Windows.  There were many earlier
  1343.      versions of DiskTrak for DOS, the last of which, version 7.40, was the
  1344.      basis for the first version of DiskTrak for Windows.  Following the release
  1345.      of DiskTrak for Windows, no further development was done on DiskTrak for
  1346.      DOS.  Instead, all new features were developed for DiskTrak for Windows. 
  1347.      When Microsoft released the Visual Basic for DOS compiler (September 1992)
  1348.      DiskTrak for Windows had evolved to a much more capable program than
  1349.      DiskTrak for DOS.  Hence the most effective approach for enhancing DiskTrak
  1350.      for DOS was to convert the Windows version to DOS.  Visual Basic for DOS
  1351.      enabled this to occur, and the result became DiskTrak for DOS Version 8.00.
  1352.  
  1353.  
  1354.                          Potential Future Enhancements
  1355.  
  1356.      Providing an install program like the installation programs accompanying
  1357.      major commercial DOS applications.  
  1358.  
  1359.      Optional automatic naming of unlabelled diskettes using a user defined
  1360.      "base" name that is incremented by the program
  1361.  
  1362.      Availabilty of shortcut keys for more program functions.
  1363.  
  1364.      If you have comments or suggestions about these (or other) enhancements to
  1365.      DiskTrak for DOS, please send them to:
  1366.  
  1367.  
  1368.  
  1369.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1370.                                         24
  1371.  
  1372.                                   DiskTrak for DOS
  1373.                                     Version 8.00
  1374.  
  1375.  
  1376.                           Birk Binnard
  1377.                           Peninsula Software
  1378.                           28510 Bluythewood Drive
  1379.                           Palos Verdes CA 90274
  1380.  
  1381.      or send a Compuserve E-Mail letter to 72356,556.
  1382.  
  1383.  
  1384.                           Un-Planned Enhancements
  1385.  
  1386.      (In other words, these are suggestions I have received but have no plans to
  1387.      implement.)
  1388.  
  1389.      Diskette label printing (i. e., including a function that prints diskette
  1390.      volume labels on a printer into which you have put diskette label paper
  1391.      stock.)
  1392.  
  1393.      "Automatic" import of comments stored in a file by some other piece of
  1394.      software.
  1395.  
  1396.      Including file size in the database.
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1431.                                         25